home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / news / DWdecode.lha / dwdecode1.02 / DWdecode.ReadMe < prev    next >
Text File  |  1997-03-28  |  6KB  |  151 lines
  1. Short:    Very SMART mass decoder of USENET binaries
  2. Uploader: dwhiting@europa.com  (Dick Whiting)
  3. Author:   dwhiting@europa.com  (Dick Whiting)
  4. Type:     comm/news
  5. Version:  V1.01 Minor fixes plus add BinHex decoding
  6. Replaces: comm/news/DWdecode*
  7.  
  8.  
  9. REQUIREMENTS: 
  10. -------------
  11.  
  12. You will need several programs/libraries from Aminet:
  13.  
  14.    RexxArpLib by Willy Langeveld  - util/rexx/ral3p3.lha
  15.  
  16.    FlashFind  by Frank Würkner    - util/cli/FlashFind1.2.lha
  17.  
  18.    A UUdecoder
  19.      e.g. UUout by Nicolas Dade   - util/arc/uuOut114.lha
  20.      
  21.    A Base64 decoder 
  22.      e.g. Base64coders by Edmund Vermeulen - comm/mail/Base64coders.lha
  23.  
  24.    A BinHex decoder 
  25.      e.g. binhex374 by Nik Soggia - util/arc/binhex374.lha
  26.  
  27.    And, of course, some Use Net files with encoded binaries;)
  28.  
  29. FILES INCLUDED IN THIS ARCHIVE:
  30.  
  31.    DWdecode               - the REAL program.
  32.    DWdecode.Base64.Types  - means of identifying Base64 first lines
  33.    DWdecode.Binary.Types  - means of identifying filenames in subject
  34.    DWdecode.Doc           - text format of documentation
  35.    DWdecode.Encode.Types  - MIME encoding types
  36.    DWdecode.Guide         - Amiga guide documentation
  37.    DWdecode.Guide.info    - info file for guide
  38.    DWdecode.Prefs         - a starter preference file
  39.    DWdecode.Readme        - copy of the Aminet readme file
  40.    DWdecode.Section.Types - describes Section lines of UUencoded files
  41.    DWdecode.Skip.Froms    - allows for filtering based on From: lines
  42.    DWdecode.Skip.Subjects - allows for filtering based on Subject: lines 
  43.    Samples/....           - subdirectory with example script(s)
  44.  
  45.    arexxqsort.lha         - handles sorting of stem variables.
  46.        by Willy Langeveld - originally found on Aminet 
  47.  
  48.  
  49. BASICS: 
  50. -------
  51.  
  52. This program does MASS decoding of Use Net files. It decodes ALL binaries
  53. that it is able to recognize, which is most;) from the source directory
  54. and optionally from ALL subdirectories as well.
  55.  
  56.  
  57. WHAT IT DOES:
  58. -------------
  59.  
  60. It uses information from MIME content lines, section lines, begin lines
  61. and (if it must) the subject line to determine what kind of encoding is
  62. used and which parts go together. It reports on files that have missing
  63. parts and on ones that it is unable to obtain complete information for.   
  64.  
  65. It handles either single directories or can handle COMPLETE directory trees.
  66.  
  67. It handles files with SINGLE & MULTIPLE UUencoded OR Base64 binaries 
  68. within them and Multipart UUencoded or Base64 files.
  69.  
  70. It handles files with APPLE/DOUBLE format. My logic uses the LAST file 
  71. of a given name within a SINGLE input file. This forces the APPLE portion
  72. to be considered a duplicate and not processed.
  73.  
  74. It allows you to filenote the decoded binaries with a variety of
  75. substitution values as well as literals. 
  76.  
  77. It is quite 'smart' and generally can figure out most files.
  78.  
  79. It is highly configurable and using external files can 'learn'.
  80.  
  81. It should work with almost ANY Base64 and UU decoder.
  82.  
  83. It allows for filtering based on From: and/or Subject: lines.
  84.  
  85. It allows for deleting input files after decoding, deleting duplicates, 
  86. deleting input files based on From: &/or Subject: lines, deleting files
  87. that have ONLY text in them, and deleting files based on their age.    
  88.  
  89. Reporting can be tailored by setting/unsetting a variety of switches on the
  90. command line or in the prefs file.
  91.  
  92. ------------------------------------------------------------------
  93.  
  94.   v1.01 Fixes/Changes:        
  95.  
  96.       Discovered that RexxTricks.Library uses the SAME function name as 
  97.          QuickSort, BUT in a different format. 
  98.          Added code to test if RexxTricks is present and to call QSORT 
  99.          in that format if necessary instead of W.L's. 
  100.          The SORTS are faster if RexxTricks.Library is NOT present,
  101.          so try to do decoding prior to anything that might add it.
  102.  
  103.       Can NOW place in directory named DWDECODE and have it WORK!! Really 
  104.          stupid error - thanks to Paul Copsey for finding this one.
  105.  
  106.       Now correctly deletes parts greater than 1 of multipart input files
  107.          when DeleteDups is specified. 
  108.  
  109.       If DWdecode MUST resort to using just Subject: line information will
  110.          now consider the SAME partname appearing multiple times in the 
  111.          subject, IFF it is the only name present, as THE name to use.
  112.  
  113.       Added support for BinHex files (only 1/1 type files). 
  114.          New variables w/defaults: 
  115.             BinHexCmd='BHD data=%DF %SF'
  116.             BinCmdFail=20
  117.  
  118.       Removed unused variable DumpB64Files from preferences/help.
  119.  
  120.       Now handles PC type lines with Ctrl-M's
  121.  
  122.       Now filenotes output files containing parens in their names
  123.  
  124.       Now writes FileNote errors to log/console as requested
  125.  
  126.       Made maximum filename length on report = 30 characters.          
  127.  
  128.       Added message referring user to logfile for errors.
  129.  
  130.       Added Guide format of 'documentation'.
  131.  
  132.  
  133.   v1.0  Initial Release
  134.  
  135. ------------------------------------------------------------------
  136.  
  137. I homeschool my kids and they would love a postcard from where EVER you live. 
  138. Instant Geography Lesson;)      
  139.                                                                           
  140. POSTCARDS:    Dick Whiting                                                
  141.               28590 S. Beavercreek Rd.                                    
  142.               Mulino, Oregon 97042                                        
  143.               USA                                                         
  144.                                                                           
  145. Bug Reports, etc:                                                         
  146.                                                                           
  147. Dick Whiting <dwhiting@europa.com>                   
  148. March 28, 1997
  149.                                                                           
  150. ------------------------------------------------------------------
  151.